* etc/PROBLEMS: Describe how to work around screen reader TAB issue
authorRobert Pluim <rpluim@gmail.com>
Mon, 21 Jul 2025 13:44:49 +0000 (15:44 +0200)
committerRobert Pluim <rpluim@gmail.com>
Mon, 21 Jul 2025 14:01:28 +0000 (16:01 +0200)
etc/PROBLEMS

index e0d34090b1e48079535ef38ae436355d15a29920..ca06ce98d04578370dc7739b13d6249bdbc60b03 100644 (file)
@@ -2678,6 +2678,18 @@ terminals, for example, like this:
 This disables 'auto-composition-mode' on frames that display on
 terminals of this type.
 
+** Screen readers get confused about character position
+
+The Emacs display code sometimes emits TAB characters purely for motion
+on the terminal, even when those characters do not exist in the buffer.
+This can confuse screen reader software under certain terminal emulators
+(rxvt and vte have been cited).  Switching to destructive tabs by running
+
+    stty -tabs
+
+in the terminal before starting Emacs may mitigate this.  See also the
+discussion in Bug#78474 <https://debbugs.gnu.org/78474>.
+
 * Runtime problems specific to individual Unix variants
 
 ** GNU/Linux